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Problem Reporting 


Preface 

This document provides the foil owing information: 

• features 

• installation information 

• related documentation 

• problem descriptions and fixes and known limitations 

Note: The software code printed in the release notes title indicates the 
software product version at the time of release. Some product and 
operating system changes do not require changes to documentation; 
therefore, do not expect a one-to-one correspondence between these 
changes and release notes updates. 

Latest printing: December 1997 

This document resides online in the file 

/opt/aCC/newconfig/RelNotes/ACXX.release.notes. You can print the 
online copy by using an ip command I ike the foil owing: 

lp — dpri ntQ"_name /opt/aCC/newconfig/RelNotes/ACXX. release, notes 

If you have any problems with the software or documentation, please 
contact your local Hewlett-Packard Sales Office or Customer Service 
Center. 
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Features 

New and Changed Features 


Features 


This chapter summarizes the features included in this version of the HP 
aC++compiler. Features introduced in prior release versions are also 
listed and grouped by the compiler version number. 

The compiler supports much of the evolving Working Paper for Draft 
Proposed I nternational Standard for I nformation Systems — 
Programming Language C++. 


New and Changed Features 

New features in H P aC++version A.01.07 are listed below. They apply to 
HP-UX 10.10 and 10.20 operating systems. 

TheHP aC++OnlineProgrammer'sGuidecontainsfull documentation. 
(See Chapter 3 of these release notes for access instructions.). 

• The aC++default template instantiation mechanism has changed to 
compile-time instantiation (CTTI). For source code containing 
templates, the new default may result in faster compile-time 
processing. 

The previous default behavior remains available by specifying the 
+inst_auto command-line option when compiling and linking. If you 
provide archive or shared libraries for distribution, you may want to 
use -Hnst_auto to insure consistent behavior between each 
distribution of your libraries. 

Also, if you provide either archive or shared library products, and 
your customers need to use the prior tempi ate instantiation default in 
their builds, you must compile your libraries by using the +inst_auto 
option. 

Refer to the H P aC-H-Online Programmer's Guide and to the online 
technical paper, Using Templates in HP aC++, for details about 
template instantiation and migration. For access instructions, see 
Chapter 3 of these release notes under Online Documentation.. 


Chapter 1 
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Features 

Version A.01.04 Features 


• Member templates are supported, including those in pre-compiled 
headers. 

• U pdated versi ons of the Rogue Wave Standard C ++ L i brary (versi on 
1.2.1) and theTools.h-H-Foundation Class Library (version 7.0.6) are 
provided. HTML documentation for these libraries is also updated; 
see Chapter 3 of these release notes under Online Documentation. 

• The HP aC-H-OnlineProgrammer's Guidehas been updated, 
including additional migration and template information. For access 
instructions, see Chapter 3 of these release notes under Online 
Documentati on. 

• The technical paper, Using Templates in HP aC++, has been updated 
to describe the new default, compile-time template mechanism and 
additional information about template libraries. For access 
instructions, see Chapter 3 of these release notes under Online 
Documentation. 


Version A.01.04 Features 

Features introduced in the prior release, H P aC-H-versi on A.01.04 are 
listed below. They apply to HP-UX 10.10 and 10.20 operating systems. 

The HP aC-H-OnlineProgrammer's Guidecontainsfull documentation. 
(See Chapter 3 of these release notes for access instructions.) 

• -FESsfc — option to replace millicodecalls with inline code when 
performing simple function pointer comparisons. 

• -Hnlinejevel — option tocontrol how C-H-inlining hints influence H P 
aC++. 

• +u — option to allow pointers to access non-natively aligned data. 
This option alters the way that the compiler accesses dereferenced 
data. Use of this option may reduce the efficiency of generated code. 

• 4W — option to selectively suppress warning messages. 

• Support for new style casts as defined in the proposed C++standard. 
The keywords const_cast, reinterpret_cast, and static_cast are 
supported. 
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Features 

Version A.01.00 Features 


• Partial support for the namespace and using keywords. User 
namespaces are supported. Standard C++Library components not in 
namespace std:: are not supported. Koenig lookup is not supported. 

• Support for class template partial specializations. 

• Extensiveonlinedocumentation is provided, including the first 
edition of the technical document, Using Templates in HP aC++. 
Refer to Chapter 3 of these release notes for details. 

• H P aC++now supports level 4 optimization. The -+04 compile-line 
option is supported. 

• H P aC++now supports profile-based optimization. The compile-line 
options -Fdfname, +1, +P and +pgmname are supported. 


Version A.01.00 Features 

Features introduced in the prior release, HP aC-H-version A.01.00, are 

listed below. They apply to HP-UX 10.10 and 10.20 operating systems. 

TheHP aC-H-OnlineProgrammer'sGuidecontainsfull documentation. 

(See Chapter 3 of these release notes for access instructions.) 

• I mproved error messages allow you to quickly isolate problems in 
your code. 

• Pre-compiled header files help you speed development substantially. 
Use them to reduce compilation time and object file size. 

• An automatic template instantiation mechanism is provided. (Note, 
as of H P a C++ version A.01.05, this mechanism is no longer the 
default, although it is available by specifying the +inst_auto 
command-line option.) 

• Explicit template instantiation (defined by the draft standard) is 
supported. 

• Application thread-safe exception handling in shared libraries is 
supported. 

• I nline functions are aggressively inlined. 

• Standards based features include the foil owing: 


Chapter 1 
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Features 

Version A.01.00 Features 


• keywords: bool, dynamic_cast, explicit, mutable, typeid, typename, 
volatile, wchar_t 

• class: typejnfo 

• explicit template instantiation 

• overloading new and delete for arrays 

• standard exception classes 

• The following libraries are provided: 

• Rogue Wave Standard C++Library Version 1.2.0, includes STL 
(updated at HP aC++Version A.01.07 to library version 1.2.1) 

• Rogue Wave Tool s.h++Version 7.0.2 Foundation Class Library 
(updated at HP aC++Version A.01.07 to library version 7.0.6) 

• cfront compatible Iostream Library 

• Standard Components Library (obsolete) 

• Extensiveonlinedocumentation is provided. Refer to Chapter 3 of 
these release notes. 

• +DA designations for PA-RI SC 2.0 model and processor numbers —to 
generate code for the PA-RI SC 2.0 systems. The -l-DAportable option 
will generate code compatible across PA-RISC 1.1 and 2.0 
workstations and servers. 

Default architecture object codegeneration is now determined 
automatically for all systems as that of the machine on which you 
compile. 

• +DS designations for PA-RISC 2.0 model and processor numbers--to 
perform instruction scheduling tuned for PA-RI SC 2.0 systems. 

Default instruction scheduling is now determined automatically for 
all systems as that of the machine on which you compile, or on the 
setting of +DA, if it is specified. 

• option -I:<Ji brary> — to support the Id feature. 

• +ESfic option -- to replace millicode calls with inline code for fast 
indirect calls. 

• 64-bit integral data types (long long and unsigned long long) are 
supported for HP a C++ applications needing large integers, such as 
large file system databases. Use the-ext command line option to 
specify. 
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Features 

Migrating from HP C++ (cfront) to HP aC++ 


• HP aC-H- features are supported by the HP Distributed Debugging 
Environment (DDE). 

• The 4help option invokes online help for the H P aC++ compiler and 
linker and libraries. 


Migrating from HP C++(cfront) to HP 
aC++ 

The compiler lists Errors, Future Errors and Warnings. Expect to see 
more warnings, errors and future errors reported in your code, many 
related to standards based syntax. Some migration issues are listed 
below; for more complete information, refer to the Migrating from H P 
C+-K cfront) to H P aC-H-section in the HP aC++Online Programmer's 
Guide 

• The overload resolution for operators has been updated to reflect the 
latest version of the evolving draft standard. You may see some 
additional "ambiguous" function error messages displayed. 

• Most frequently reported migration issue: enum x {xl, }; The trailing 
comma is an error. 

• Changes to temporary creation for rvalues used to initialize return 
values which are const references now causes: 

Error 652: Exact position unknown; near file, line#. 
Initialization of the result <some const &> requires creating a 
temporary, yet the temporary's lifetime ends with the return 
from the function. 

• You can bracket your H P aC-H-changes with the macro defined by the 
draft standard. For example: 

#if _cplusplus >= 199707L 

// HP aC++ Code 

#endif // _cplusplus >= 199707L 

• If you are using directed mode instantiation with the cfront based 
compiler, an awk script can be used to convert your file to an 
instantiation file that uses the explicit instantiation syntax. Note 
that explicit instantiation syntax can be used to instantiate a 
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Features 

Migrating from HP C++ (cfront) to HP aC++ 


template and all of its member functions, an individual template 
function, or a tempi ate cl ass's member function. The H P aC++Online 
Programmer's Guide contains an example script. 
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Installation Information 

Current Run-time Support Library Required 


I nstal I ati on I nformati on 


Read this entire document and any other release notes or readme files 
you may have before you begin an installation. 

To install your software, run the SD-UX swinstall command. It will 
invoke a user interface that will lead you through the installation. For 
more information about installation procedures and related issues, refer 
toManaging FIP-UX Softwarewith SD-UX and other README, 
installation, and upgrade documentation provided or described in your 
H P-UX 10.x operating system package. 

Depending on your environment, you may also need documentation for 
other parts of your system, such as networking, system security, and 
windowing. 

H P aC-H-requires approximately 80 MB of disk space: 25 MB for the files 
in /opt/aCC and 30 MB for DDE, Blink Link, and HP/PAK. 


Current Run-time Support Library 
Required 

To work correctly, an application must be linked to or run with an HP 
aC++ run-time support library (libCsup.a or libCsup.sl) that comes with 
this version of H P aC-H-or a subsequent version. Linking with an older 
version of libCsup.a or running your application with an older version of 
libCsup.sl (the default) may cause spurious failures. 


Chapter 2 
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Installation Information 

Attention Softbench Users 


Attention Softbench Users 

You should install Softbench (DDE and PAK) before installing H P aC++. 
This is because HP aC-H-is packaged with DDE and a DDE specific 
patch. Not installing in this order results in an unsupported 
configuration. 
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Related Documentation 

Online Documentation 


Related Documentation 


Documentation for HP a C++ is described in the foil owing sections. 


Online Documentation 

The following online documentation is included with theHP aC++ 
product. 

HP aC-H-Online Programmer's Guide 

Access the guide in any of the foil owing ways: 

• Use the+help command-line option. (Be sure/opt/aCC/bin/ is in your 
path.) 

aCC +help 

• Select the ? icon on theHP Vue or HP CDE front panel. 

• Use one of the foil owing commands: 

HP VUE users, enter the helpview command which is in either 
/usr/vue/bin or /usr/vhelp/bin. 

HP CDE users, enter the foil owing command: 

/usr/dt/bi n/dthel pview -hel pVol ume /opt/aCC/hel p/C/ACXX.hv 

Using Templates in HP aC++ 

This technical document summarizes template features defined in the 
proposed C++standard and describes template instantiation as 
implemented in HP aC++. It isprovided with HP aC++in both postscript 
and HTML format in the following locations: 

/opt/aC C/newconfi g/T ecD ocs/templ ates. ps 

/opt/aC C/newconfi g/T ecD ocs/templ ates. ht m 
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Related Documentation 

Online Documentation 


NOTE NOTE: The +help option may not work on systems running HP CDE. If 

it does not work, ensure the environment variable 
DTHELPSEARCHPATH is set. (It may not beset if you rlogin to a 
system, for example.) If it is not set, use the foil owing command to set it 
(for ksh): 

eval $(/usr/dt/bin/dtsearchpath) 

Ensure the LANG environment variable is set, typically LANG=C. 


HP-UX Linker and Libraries Online User 
Guide 

This Guide may not be installed on pre-H P-UX 10.20 systems. I n this 
case, refer tothe later section in this chapter, Linker Compatibility 
Warnings, for valuable information. 

Toaccess, use the linker command with the+help option. (Besure 
usr/ccs/bin/ is in your path.) 

Id +help 

HP DDE Debugger OnlineHelp 

Select help from the DDE Menu Bar.: 


NOTE NOTE: Users with character-based terminals or terminal emulators can 

invoke the charhelp program to view or print the online help provided for 
C++and the linker. To start charhelp enter the full pathname (or just 
charhelp if/opt/I angtool s/bin is in your $PATH environment variable), 
and you will see a usage statement: 

$ /opt/langtools/bin/charhelp 

charhelp: Usage: charhelp { aCC I cc I CC I f77 | Id I -helpVolume 
file} 

For help with H P aC++for example, enter charhelp ACXX and follow the 
menus for further direction. For more information, seethe man page for 
<charhelp>(l). (/opt/langtools/share/man/manl.Z must be in your 
$MANPATH environment variable). 


On HP-UX 10.10 systems, charhelp may not be available.. 
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Related Documentation 

Online Documentation 


Rogue Vtave Software Standard C++Library 
1.2.1 Class Reference 

This reference provides an alphabetical listing of all of the classes, 
algorithms, and function objects in the Rogue Wave implementation of 
the Standard C++Library. It is provided as HTML formatted files. You 
can view these files if you have access to an HTM L viewer such as 
Netscape. To do so, open thefile/opt/aCC/html/libstd/ref.htm 

Rogue Wave Software Tool s.h++ 7.0.6 Class 
Reference 

This reference describes all of the classes and functions in theTools.h++ 
Library. It is provided as HTML formatted files. You can view these files 
if you have access to an HTML viewer such as Netscape. Todoso, open 
the file/opt/aCC/html/librwtool/ref.htm 


NOTE Refer to the I nformation Map in the HP aC++Online Programmer's 

Guidefor how to obtain additional Rogue Wave documentation and 
information. 

HP a C++ Release Notes 

This is the document you are reading. The online ASCI I file can be found 
in /opt/aCC/newconfig/RelNotes/ACXX.release.notes 

HP PA-RISC Compiler Optimization 
Tech nol ogy Wh i te Pa per 

This paper describes the benefits of using optimization. It is available in 
the postscript file/opt/langtools/newconfig/white_papers/optimize.ps 

Online Manual Pages 

Online manual pages for aCC and c++filt are at 
/opt/aCC/share/man/manl.Z. 

Manual pages for the Standard C++Library and thecfront compatibility 
libraries (I OStream and Standard Components) are provided under 
/opt/aCC/share/man/man3.Z. (Notefor Standard Components only, 
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Related Documentation 

Printed Documentation 


invoke a man page by entering 3s after the man command and before the 
man page name. For example, to invoke the man page for Args: man 3s 
Args) 

J apanese man pages are located at: 

/opt/aCC/share/man/ja_JP.eucJP/manl.z and 

/opt/aCC/share/man/ja_JP.eucJP/man3.z (euc character set) 

/opt/aCC/share/man/ja_JP.SJIS/manl.z and 

/opt/aCC/share/man/ja_JP.SJIS/man3.z (SJIS character set) 

Online C++Example Source Files 

Online C++example source files are located in the directory, 
/opt/aCC/contrib/Examples/RogueWave. These include examples for the 
Standard C++Library and for theTools.h++Library. 


Printed Documentation 

• HP aC++Release Notes is this document. A printed copy of the 
release notes is provided with the H P aC++product. 

Release notes are also provided online, as noted above. 

The foil owing documentation is available for use with HP aC++. To order 

printed versions of Hewlett-Packard documents, refer to manuals(5). 

• HP/ DDE Debugger User's Guide contains information on debugging 
C++programs with theHP Distributed Debugging Environment on 
the H P 9000. 

• Getting Started with SoftBench on HP-UX 10.xcontains SoftBench 
tutorials for C, C++, and COBOL. 

• C and C-H-SoftBench User's Guide for HP-UX 10.x contains 
information on using C and C++SoftBench. 

• I nstalling and Customizing SoftBench Products contains installation 
and customization information for SoftBench Products on HP-UX 9.x, 
H P-UX 10.x and Solaris. 
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Related Documentation 

Other Documentation 


Other Documentation 

Refer to the H P a C++ Online Programmer's Guide I nformation Map for 
documentation listings, URL's, and course information related tothe 
C++ language. Also, see below. 

Content of .o Files may Change 

The foil owing applies when you use an aCC command-line option that 
invokes the assigner. 

The content of a given . 0 file can potentially change when it is used in a 
closure (with the +inst_close option) or link operation. The change may 
occur in either of the following cases: 

• You change the order of .0 file's on thelink line. For example, if you 
compile and link A.c and B.c multi pie times as follows, the contents of 
A.oand B.o may not be the same foil owing the second link as they 
were foil owing the first link: 

aCC -c A.c B.c 
aCC A.o B.o 

aCC -c A.c B.c 
aCC B.o A.o 

• You link a .0 file with different objects. In the foil owing example, the 
content of A .0 may not be the same foil owing the second link as it was 
foil owing the first link: 

aCC A.o B.o 
aCC A.o C.o 

The Named Return Value (NRV) Optimization 

Syntax: -Wc,-nrv_optimization,[off|on] 

The above syntax disables (default) or enables the named return value 
(NRV) optimization. For this optimization to work correctly in 
conjunction with exception handling, the application must be linked to 
an aC++run-time support library that comes with FI P aC++A.01.04 or a 
subsequent version. Linking with a prior library may cause spurious 
failures. If the shared version of this library is selected (default), the 
platform on which the application is run must also have that release of 
the H P aC++ run-time support library (libCsup.sl). 
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Related Documentation 

Other Documentation 


TheNRV optimization eliminates a copy-constructor call by allocating a 
local object of a function directly in the caller's context if that object is 
always returned by the function. For example: 

struct A { 

A(A constS); // copy-constructor 

}; 


A f(A constS x) { 

A a(x); 

return a; // Will not call the copy constructor if the 
} // optimization is enabled. 

This optimization will not be performed if the copy-constructor was not 
declared by the programmer. Note that although this optimization is 
allowed by the ISO/ANSI C++working paper, it may have noticeable 
side-effects. 

Example: aCC -Wc,-nrv_optimization,on app.C 

Linker Compatibility V\fernings 

Beginning with the H P-UX 10.20 release, the linker generates 
compatibility warnings. These warnings include H P 9000 architecture 
issues, as well as linker features that may change over time. 

Compati bi I ity warni ngs can be turned off with the 
+v[no]compatwarnings linker option. Also, detailed warnings can be 
turned on with the +vallcompatwarnings linker option. 

Link time compatibility warnings include the foil owing: 

• Linking PA-RI SC 2.0 object files on any system — PA-RI SC 1.0 
programs will run on 1.1 and 2.0 systems. PA-RI SC 2.0 programs will 
not run on 1.1 or 1.0 systems. 

• Dynamic linking with -A — If you do dynamic linking with -A, you 
should migrate to using the Shared Library Management Routines. 
These routines are also described in thesh_load(3X) man page. 

• Procedure call parameter and return type checking (which can be 
specified with -C) — The current linker checks the number of 
symbols, parameters, and procedure calls across object files. I n a 
future release, you should expect H P compilers to perform 
cross-module type checking, instead of the linker. This impacts H P 
Pascal and HP Fortran programs. 
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Related Documentation 

Other Documentation 


• Duplicate names found for code and data symbols — The current 
linker can create a program that has a code and data symbol with the 
same name. I n a future H P-UX release, the linker will adopt a single 
name space for all symbols. This means that code and data symbols 
cannot share the same name. Renaming the conflicting symbols 
solves this problem. 

• Unsatisfied symbols found when linking to archive libraries — If you 
specify the-v option with the +vallcompatwarnings option and link to 
archive libraries, you may see new warnings. 

• Versioning within a shared library — If you do versioning within a 
shared library with theHP_SHLIB_VERSION (C and C++) or the 
SH LI B_VERSI ON (Fortran and Pascal) compiler directive, you 
should migrate to the industry standard and faster performing 
library-level versioning. 
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Other Documentation 
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Problem Descriptions and Fixes and Known Limitations 

Known Problems 


Problem Descriptions and Fixes 
and Known Limitations 


This chapter summarizes the known problems and limitations of the 
current version of H P aC++except as otherwise noted. 

HP-UX 10.10 is the last supported OS for PA-RI SC 1.0 architecture 
machines. H P-UX 10.20 no longer supports execution of PA-RI SC 1.0 
code, and 10.20 compilers no longer support the compilation of PA-RI SC 
1.0 code. 

Seethe latest HP-UX Software Status Bulletin support document for 
other known problems. 


Known Problems 

Customers on support can use the product number to assist them in 
finding SSB and SRB reports for H P aC++. The product number you can 
search for is B3910BA. 

To verify the product number and version for your HP aC-H-compiler, 
execute the fol I owi ng H P-U X commands: 

what /opt/aCC/lbin/ctcom 
what /opt/aCC/bin/aCC 

To verify the product number and version for the linker: 

what /opt/aCC/bin/ld 

To verify the product number and version for the shared library 
initializer: 

what /usr/lib/aCC/dld.si 

Following are known problems and workarounds. 
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Problem Descriptions and Fixes and Known Limitations 

Known Problems 


Unsatisfied Symbols if Using Non-current 
Support Library 

If you see a message I ike the foil owing, you may be using a non-current 
version of the HP aC-H-run-time support library. 

/opt/aCC/lbin/ld: Unsatisfied symbols: 

Class tables [Vtable] dependent on key function: 

"_versioned_type_info::~_versioned_type_info ()" (data) 

For example, if you are a library distributor, you must ensure that your 
customers use the same or a newer version of the libCsup run-time 
library as you. If necessary, you should install the most current H P 
aC-H-library support patch and distribute this patch to your customers. 

As of the date of these release notes, the most current library support 
patch number is: PHSS_12609 

Syntax Errors when Using 
/usr/i ncl ude/sys/ti me.h 

If you see the following error message, it means that 
CLOCKS_PER_SEC is not defined: 

Error 171: "7198. C", line 2 # Undeclared variable 
'CLOCKS_PER_SEC'. int i = CLOCKS_PER_SEC; 

The workaround is to modify the/usr/i ncl ude/sys/ti me.h file as follows: 

1. Find the first occurence of: 

#endif /* _INCLUDE_STDC_ */ 

2. Immediately before the first occurenceof the aboveline, add the 
following code, replacing SomeValue with the value you need 
(1000000 would be the system default): 

#else 

tifdef _cplusplus 

fdefine CLOCKS.PER_SEC SomeValue 
#endif 

The /usr/i ncl ude/sys/ti me.h file contains a K & R style fundi on 
declaration for which HP aC-H-generates an error I ike the foil owing: 

Error 43: "/usr/include/sys/time.h", line 487 # C++ does not allow 
Old-style (non-prototype) function definitions. 
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Problem Descriptions and Fixes and Known Limitations 

Known Problems 


To workaround, whenever time.h is included by a source program, you 

can define the_STDC_macro on your command-line, as in the 

following example: 


aCC -D_STDC_ 

Or you can install the appropriate patch listed below: 


PHKL_8691 

PHKL_8692 

PHKL_8693 

PHKL_8694 


series 700 
series 800 

series 700 
series 800 


HP-UX 10.10 

HP-UX 10.20 


HP aC-H-generatres an error like the foil owing stating that structs or 
any types cannot be declared extern. 


Error 608: "/usr/include/sys/time.h", line ??? # Types may not be 
declared static, auto, register, extern or mutable, 
extern struct sigevent; 


The error is caused by a problem in the/usr/include/sys/time.h file. To 
workaround, you can change the line extern struct sigevent; in the 
time.h file to: 

struct sigevent; 

Or you can install the appropriate patch listed below: 

PHKL_7962 series 700 HP-UX 10.20 

PHKL_7963 series 800 

Syntax Problems when Using 
/usr/i ncl u d e/mat h.h 

To resolve a conflict between the exception struct in 

/usr/include/sys/math.h and the aC-H-exception struct, the workaround 

is to modify the /usr/i ncl ude/math.h file as follows: 

1. Find the line: 

fdefine _MATH_INCLUDED 

2. I mmediately following the above line, add the next line: 

#define exception math_exception 

3. Find the line: 

#endif /* _MATH_INCLUDED */ 

4. I mmediately before the above line, add this line: 

#undef exception 
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Alternatively, you can install thePHCO_9261 patch. 


Warnings when using /usr/include/rpc/xdr.h 

Compile-time warnings I ike the foil owing should be ignored. They are 
caused by an incorrect prototype in the/usr/include/rpc/xdr.h file. 

Warning 301: "/YourFileName/usr/include/rpc/xdr.h", line 276 # The 
(...) parameter list is a non-portable feature. 

extern bool_t xdrrec_eof(_o); /* true iff no more input */ 


Known Limitations 

Some of these limitations will be removed in future releases of H P aC++. 

Please be aware that some of these limitations are platform-specific. 

• H P aC-H-does not support the xdb debugger. I nstead, use the H P 
DDE debugger supplied with the product. 

• HP aC-H-does not and will not in the future support installation 
and/or execution on H P-UX 9.x systems. 

• HP aC-H-does not support large files (i.e., greater than 2 GB) with 
<iostream.h>. 

• Note that although the compiler will run on the PA Rl SC 1.0 
architecture, an H P aC-H-executable will run only on the PA Rl SC 
1.1 or later architecture. 

• Known limitations of exception handling features: 

• I nteroperability with setjmp/longjmp (undefined by the C++draft 
proposed international standard) is unimplemented. Executing 
longjmp does not cause any destructors to be run. 

• If an unhandled exception is thrown during program initialization 
phase (that is, before the main program begins execution) 
destructors for some constructed objects may not be run. 

• Symbolic debugging information is not always emitted for objects 
which are not directly referenced. For instance, if a pointer to an 
object is used but no fields areever referenced, then HP aC-H-only 
emits symbolic debug information for the pointer type and not for 
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the type of object that the pointer points to. For instance, use of 
Widget * only emits debug information for the pointer type 
Widget * and not for Widget. If you wish such information, you can 
create an extra source file which defines a dummy function that 
has a parameter of that type (Widget) and link it into the 
executable program. 

• Known limitations of signal handling features: 

• Throwing an exception in a signal handler is not supported, since 
a signal can occur anyplace, including optimized regions of code 
in which the values of destructableobjects are temporarily held in 
registers. Exception handling depends on destructableobjects 
being up-to-date in memory, but this condition is only guaranteed 
at call sites. 

• Issuing a longjmp in a signal handler is not recommended for 
the same reason that throwing an exception is not supported. 

The signal handler interrupts processing of the code resulting 
in undefined data structures with unpredictable results. 

• Source-level debugging of C-H-shared libraries is supported. 
However, there are limitations related to debugging C-H-shared 
libraries, generally associated with classes whose member functions 
are declared in a shared library, and that have objects declared 
outside the shared library wherethe class is defined. Refer to the 
appropriate release notes and manuals for the operating system and 
debugger you are using. 

Refer also to the Software Status Bulletin for additional details. 

• I nstantiation of shared objects in shared memory is not supported. 

• When you call the <shl_load>(3) routines in libdld.sl either directly or 
indirectly (as when your application calls use the +A option, you will 
get an "unresolved externals" error. 

If you want to link archive libraries and libdld.sl, usethe-WI,-a, 
archive option. The foil owing example directs the linker to use the 
archive version of standard libraries and (by default) libdld.sl. 

aCC prog.o -Wl,-a,archive 

• Using shl_load(3X) with Library-Level Versioning 
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Once library-level versioning is used, calls to shl_load() (see 
shl_load(3X)) should specify the actual version of the library that is to 
be loaded. For example, if libA.sl is now a symbolic link to libA.l, then 
calls to dynamically load this library should specify the latest version 
available when the application is compiled, such as: 

shl_load("libA.1", BIND_DEFERRED, 0); 

This will insure that, when the application is migrated to a system 
that has a later version of IibA available, the actual version desired is 
the one that is dynamically loaded. 

• Memory Allocation Routine allocaO 

The compiler supports the built in function, alloca, defined in the 
/usr/include/alloca.h header file. The implementation of the allocaO 
routine is system dependent, and its use is not encouraged. 

allocaO is a memory allocation routine similar to mallocO (see 
malloc(3C)). The syntax is: 

void *alloca(size_t <size>); 

allocaO allocates space from the stack of the caller for a block of at 
least <size> bytes, but does not initialize the space. The space is 
automatically freed when the cal ling routine exits. 


NOTE Memory returned by allocaO is not related to memory allocated by other 

memory allocation functions. Behavior of addresses returned by allocaO 
as parameters toother memory functions is undefined. allocaO can only 
be called from a non-inline function. 


To use this function, you can use the oil oca.h> header file or you can 
specify your own prototype and use the -FOlibcalls option. 
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